--== READ ME ==--.txt
========================================
doompal v1.1.0 - Doom Palette Tools
========================================
USAGE:
doompal <input> Auto-batch mode
doompal <command> <input> [output] [options]
COMMANDS:
cube <input> [output.cube] Generate .cube LUT for image editors
batch <input> <o> Generate all files (cube, playpal, colormap, split)
playpal <input> [output] [--slade] [--blank] Generate 256×14 PLAYPAL
colormap <input> <o> [--blank] Generate 256×34 colormap with lighting
blank <input> <o> Generate blank playpal + colormap (no tints/lighting)
slade <input> <o> [--all] [--cell N] Generate SLADE-style 16×16 grid palette
extract <wad> [output] [options] Extract PLAYPAL/COLORMAP from WAD
split <input> <o> Generate transparent tint overlay PNG
cleanpal <input> [--rgb] [--tolerance N] Find duplicate/similar pal0 entries
[--layers]
COMMAND DETAILS:
cube Inputs pal0, outputs LUT cube for sRGB image editing apps
batch Inputs pal0, outputs:
- .cube LUT file
- 256×14 playpal.png
- 256×34 colormap.png
- transparent tint split.png
playpal Input pal0, output 256×14 playpal PNG
--slade : Output binary playpal.pal instead of PNG
--blank : All 14 rows same (no tinting)
colormap Input pal0, generate primary colormap with lighting
--blank : No lighting (full brightness rows 0-31)
blank Input pal0, output both:
- blank playpal (no tints)
- blank colormap (no lighting)
slade Input palette, generate SLADE-style 16×16 grid pal0.png
--playpal : Output binary playpal.pal (14 palettes) instead of PNG
--cell N : Cell size (default 8 = 128×128 output)
extract Extract from WAD (PLAYPAL + primary COLORMAP if found)
--boom LUMPNAME : Extract specific Boom colormap
--boom : Extract all Boom colormaps
--boomlist : List all Boom colormaps in WAD
split Input pal0, output transparent overlay PNG showing
damage/item/radsuit tints (apply to blank playpals)
cleanpal Find IDENTICAL (exact) and SIMILAR (perceptual) pal0
entries. Lowest index kept, rest cleared. Outputs
identical/simular (cleared pixels, original positions,
transparent bg) and aligned (kept colours packed from
slot 0, transparent tail). Never auto-batched.
--rgb : Weighted RGB metric (default tolerance 1.1)
instead of CIE Lab dE76 (default 2.0)
--tolerance N : Override tolerance (decimals ok)
--layers : One PNG per set/cluster (-keepNNN files)
SUPPORTED INPUT FORMATS:
- playpal.pal SLADE binary (14 palettes, 10752 bytes)
- pal0.pal SLADE binary (single palette, 768 bytes)
- pal0.png 256×1 PNG (DoomTools style)
- playpal.png 256×14 PNG (DoomTools style)
- colormap.png 256×34 PNG (extracts row 0 as pal0)
- slade_pal0.png 16×16 grid PNG (SLADE style)
- *.wad WAD files (extracts PLAYPAL lump)
Note: Binary colormap lumps (.cmp) are NOT valid inputs
OPTIONS:
-h, --help Show this help
--version Show version
NOTES:
Running 'doompal <inputfile>' with no command automatically runs batch mode
EXAMPLES:
doompal mywad.wad
Auto-batch: cube + playpal + colormap + split from the WAD's PLAYPAL
doompal cube pal0.png
Make a .cube LUT for image editors
doompal playpal pal0.pal playpal.png --blank
Blank 256×14 playpal PNG (all rows identical, no tints)
doompal slade playpal.pal mypal --cell 16
SLADE-style grid at 256×256 (16px cells)
doompal extract doom2.wad --boomlist
List Boom colormaps inside a WAD
doompal cleanpal playpal.png
Duplicate/similar colour analysis (CIE Lab, tolerance 2.0)
doompal cleanpal doom2.wad --tolerance 2.3 --layers
Analyse the WAD's PLAYPAL, plus one PNG per duplicate group
doompal cleanpal pal0.png --rgb
Legacy weighted-RGB metric (tolerance 1.1)
----------------------------------------
How to use
----------------------------------------
Place the bat file and the script file
in a dir which has been added to your
path. Then simply run it via the bat
filename from any location on your
computer using the command line.
----------------------------------------
Python Dependancies
----------------------------------------
py -m pip install --upgrade pip
py -m pip install Pillow numpy